home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / lists / mint / l_0799 / 748 < prev    next >
Encoding:
Internet Message Format  |  1994-08-27  |  3.7 KB
  1. From: mh1@irz301.inf.tu-dresden.de (Michael Hohmuth)
  2. Subject: Re: ext. ARGV
  3. Date: Mon, 10 Jan 1994 17:32:35 +0100 (MET)
  4. In-Reply-To: <9401100743.AA15875@math.uni-muenster.de> from "Julian Reschke" at Jan 10, 94 08:43:58 am
  5. Mime-Version: 1.0
  6.  
  7. > I think I remember that the format was
  8. > 
  9. > ARGV=NULL:<string>
  10. > 
  11. > where <string> contains a '0' for empty args and '1' for the others.
  12. > The MiNT-Lib startup seems to use:
  13. > 
  14. > idx,idx,...
  15. > 
  16. > Where idx are decimal encoded positions of empty args. Is this really the
  17. > 'right' way?
  18.  
  19. I think so.  This is the way we agreed on when I proposed this ARGV
  20. extension, which was why I implemented it that way in mntlib.
  21.  
  22. I ship my distributions of `sh' and `tcsh' with the following document
  23. which summarizes the proposal:  [ below my .signature ]  I encourage
  24. everyone to spread it to clear up any confusion.
  25.  
  26. Greetings,
  27. Michael
  28. -- 
  29. Internet: hohmuth@freia.inf.tu-dresden.de
  30.  
  31.  
  32. This is a proposal for an extension of Atari's ARGV argument passing scheme
  33. standard.  It has been discussed on the MiNT mailing list.  Please note
  34. that this proposal should not yet be regarded as an "official" Atari
  35. standard; however, according to Atari's Eric Smith, it's unlikely that
  36. Atari's new standard will differ a lot from the one proposed here.
  37.  
  38.                                   *
  39.  
  40. This ARGV standard extension adds the possibility of passing blank (i.e.,
  41. zero length) arguments via the command line when calling another program.
  42.  
  43. The ARGV extended argument passing scheme standard should be extented by
  44. the following clauses:
  45.  
  46.     If the command line does _not_ contain blank arguments, the old ARGV 
  47.     standard applies; there are no additions.  This is for maximal 
  48.     backwards compatibility with old (unaware) applications.
  49.  
  50.     _If_ (and only if) there are blank arguments, they're substituted by 
  51.     single spaces in the argv[] representation in the environment and
  52.     by the string "''" (two single quotes) in the basepage's command 
  53.     line representation.  Their position in argv[] is signaled thru the 
  54.     value of the "ARGV=" environment variable (which was reserved by 
  55.     Atari's earlier standard for future usage).  This value consists of 
  56.     the string "NULL:", followed by a comma-separated list of decimal-
  57.     encoded indexes to the positions of the blank arguments in the 
  58.     argv[] vector.
  59.  
  60. Example:  The following command:
  61.     foo bar '' '' blah '' frob
  62. results in the following being appended to the child's environment:
  63.     "ARGV=NULL:2,3,5\0foo\0bar\0 \0 \0blah\0 \0frob\0\0"
  64. The basepage contains the following string at offset 0x80:
  65.     "\177bar '' '' blah '' frob\0"
  66.  
  67. A program which is aware of the new standard will notice the magic word 
  68. "NULL" in ARGV's value and will decode the argv[] indexes it signals.
  69.  
  70. A program which is not aware of the new standard, but which is aware
  71. of Atari's old ARGV standard will see spaces in place of blank
  72. arguments.  The spaces have been introduced to guarantee that
  73. the parameters stay on their positions.
  74.  
  75. Non-ARGV-aware programs (those which read their command line from their
  76. basepage) should see the parameters in the right place too..  Of course,
  77. a space can't be inserted in place of an blank argument because spaces
  78. separate words in the basepage's command line, which is why the single
  79. quotes have been introduced.
  80.  
  81. Those programs that use the value of ARGV= for other purposes (Mark
  82. Williams C compiled programs) will conform/work as long as they're not
  83. passed blank args.  If someone tries to pass blank args to them from an
  84. aware shell, these programs will lose.  However, these programs would
  85. also lose in this case if the (new) standard wouldn't exist (because
  86. blank arguments are impossible resp. truncate the ARGV parameters in the
  87. environment), so this is not really a problem.
  88.